From 2f6c90636d3abae68bc0f772215033287164ca52 Mon Sep 17 00:00:00 2001 From: Tom Schoonjans Date: Sun, 9 Jul 2017 18:04:06 +0100 Subject: [PATCH] GtkFileChooserNative: documentation updated https://bugzilla.gnome.org/show_bug.cgi?id=784723 --- gtk/gtkfilechoosernative.c | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/gtk/gtkfilechoosernative.c b/gtk/gtkfilechoosernative.c index 7314fd67c8..8476bcdc41 100644 --- a/gtk/gtkfilechoosernative.c +++ b/gtk/gtkfilechoosernative.c @@ -50,8 +50,8 @@ * #GtkFileChooserNative is an abstraction of a dialog box suitable * for use with “File/Open” or “File/Save as” commands. By default, this * just uses a #GtkFileChooserDialog to implement the actual dialog. - * However, on certain platforms, such as Windows, the native platform - * file chooser is uses instead. When the application is running in a + * However, on certain platforms, such as Windows and macOS, the native platform + * file chooser is used instead. When the application is running in a * sandboxed environment without direct filesystem access (such as Flatpak), * #GtkFileChooserNative may call the proper APIs (portals) to let the user * choose a file and make it available to the application. @@ -187,6 +187,22 @@ * * Use of custom previews by connecting to #GtkFileChooser::update-preview. * * * Any #GtkFileFilter added with a custom filter. + * + * ## macOS details ## {#gtkfilechooserdialognative-macos} + * + * On macOS the NSSavePanel and NSOpenPanel classes are used to provide native + * file chooser dialogs. Some features provided by #GtkFileChooserDialog are + * not supported: + * + * * Extra widgets added with gtk_file_chooser_set_extra_widget(), unless the + * widget is an instance of GtkLabel, in which case the label text will be used + * to set the NSSavePanel message instance property. + * + * * Use of custom previews by connecting to #GtkFileChooser::update-preview. + * + * * Any #GtkFileFilter added with a custom filter. + * + * * Shortcut folders. */ enum { -- 2.30.2